GitHub 下增加项目主页

作者 Simmin 日期 2017-12-06
GitHub 下增加项目主页

以我个人为例,已经在GitHub上通过hexo.github.io仓库建立了个人主页,首页也通过http://<username>.github.io能够访问,但是现在想建立一个demo项目用于展示博客中提到的例子。

本地hexo项目目录:
hexo-pro-content
远程GitHub项目目录:
github-pro-content

也就是说本地编辑时的目录和hexo生成后push到GitHub上并不一样,GitHub上的项目文件是其实是hexo项目中的public文件夹中的文件,但是hexo每更新一次public文件夹的内容都会重新生成,因此我们无法通过试图在public目录中增加文件/文件夹来实现我们的目的。

首先,需要了解一下GitHub上创建GitHub Pages的两种方式:

  1. 通过创建名为.github.io的repo创建个人主页

    这样创建的repo,对应的是master分支,一切更改也在master分支上进行。对外访问链接直接为http://<username>.github.io。如果再创建gh-pages分支,那么master分支和gh-pages会自动同步(经过测试猜测如此,并不一定正确)。

  2. 通过gh-pages分支创建项目主页

    新建任意名字repo(非.github.io),比如project,新建gh-pages分支,一切更改在gh-pages上进行。对外访问链接为http://<username>.github.io/project

现在如果要实现文章开头说的效果,考虑到方式1中master分支和gh-pages分支会自动同步的问题,所以只能用方式2,那么思路也就清晰了。

  1. 新建名为blog-demo的repo
    create-repo

  2. 克隆到本地

    git clone https://github.com/<username>/blog-demo.git
  3. 新建gh-pages分支

    git checkout -b gh-pages
  4. 创建demo.html

    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta charset="UTF-8">
    <title>Document</title>
    </head>
    <body>
    blog-demo下的demo页面
    </body>
    </html>
  5. 同步到远程服务器

    git push origin gh-pages
  6. 通过url访问
    demo

参考文章:

  1. 单个GitHub帐号下添加多个GitHub Pages的相关问题